.. _cmmCfgSetFilter:

cmmCfgSetFilter
==================
------------------

SYNOPSYS
`````````

.. code-block:: none

    VT_I4 cmmCfgSetFilter (
        [in] VT_I4 Axis, [in] VT_I4 IsEnable
        )

DESCRIPTION
`````````````

- 각종 I/O 신호에 필터 로직을 적용할지를 설정합니다.(필터 로직이 적용되면 펄스폭이 너무 짧은 입력 신호는 무시됩니다.)


PARAMETER
```````````

- Axis: 축번호. 축번호는 상수값으로 [cmX1] 부터 0 번째 축을 기준 축으로 임의의 축을 설정할 수 있습니다.

- IsEnable : cmmCfgSetFilter 함수의 인자이며, 필터로직을 적용 여부를 설정합니다.

+-----------+------------------------------------+
|   Value   | Meaning                            |
+===========+====================================+
|     0     | Filter Disable(필터 로직 비활성화) |
+-----------+------------------------------------+
|     1     | Filter Enable (필터 로직 활성화)   |
+-----------+------------------------------------+


SEE ALSO
`````````

+-----------------------------+------------------------------------------------+
|          필터 적용 I/O      |                    필터 기준                   |
+=============================+================================================+
| +EL, -EL, SD, ORG, ALM, INP | 펄스폭이 4㎲ 미만은 무시                       |
+-----------------------------+------------------------------------------------+
|          +DR, -DR           | 펄스폿이 3.2ms 미만은 무시                     |
+-----------------------------+------------------------------------------------+


RETURN VALUE
`````````````

+--------------+----------------+
| Value        | Meaning        |
+==============+================+
| 음수         | 수행 실패      |
+--------------+----------------+
| cmERR_NONE   | 수행 성공      |
+--------------+----------------+


Example
`````````

.. code-block:: c++
 :linenos:
 :emphasize-lines: 5

 C/C++

 #include “Cmmsdk.h”
 #include “CmmsdkDef.h”

 void OnSetNoiseFilter ()
 {
    long nAxisNo = 1; // Noise Filter 기능을 적용할 대상 축 선택.
    long nFilterEnable; // Noise Filter 기능 활성 상태 정보.

    /* 노이즈 필터 로직 활성 여부를 확인하여 비활성 상태이면 활성 상태로 설정합니다. */
    if (cmmCfgGetFilter ( nAxisNo, &nFilterEnable ) == cmERR_NONE )
    {
        if ( nFilterEnable != cmTRUE)
        {
            // Noise Filter Enable
            cmmCfgSetFilter ( nAxisNo, cmTRUE);
        }
    }
 }

 ---------------------------------------------------------------------------------------------------------------
 Visual Basic

 Private Sub OnSetNoiseFilter ()

    Dim nAxisNo As Long ‘ Noise Filter 기능을 적용할 대상 축 선택.
    Dim nFilterEnable As Long ‘ Noise Filter 기능 활성 상태 정보.

    nAxisNo = 1

    ‘ 노이즈 필터 로직 활성 여부를 확인하여 비활성 상태이면 활성 상태로 설정합니다.
    If cmmCfgGetFilter ( nAxisNo, nFilterEnable ) = cmERR_NONE Then

        If nFilterEnable <> cmTRUE Then
            ‘ Noise Filter Enable
            Call cmmCfgSetFilter ( nAxisNo, cmTRUE)
        End If
    End If

 End Sub
 
 ---------------------------------------------------------------------------------------------------------------
 Delphi

 procedure OnSetNoiseFilter ();
 var
    nAxisNo : LongInt; // Noise Filter 기능을 적용할 대상 축 선택.
    nFilterEnable : LongInt; // Noise Filter 기능 활성 상태 정보.
 begin
        nAxisNo := 1;

    // 노이즈 필터 로직 활성 여부를 확인하여 비활성 상태이면 활성 상태로 설정합니다.
    if cmmCfgGetFilter ( nAxisNo, @nFilterEnable ) = cmERR_NONE then
    begin
        if nFilterEnable <> cmTRUE then
        begin
            // Noise Filter Enable
            cmmCfgSetFilter ( nAxisNo, cmTRUE );
        end;
    end;

 end;

 

.. seealso:: :ref:`cmmCfgGetFilter`